home *** CD-ROM | disk | FTP | other *** search
/ PC World 2006 July & August / PCWorld_2006-07-08_cd.bin / komunikace / apache / apache_2[1].2.2-win32-x86-no_ssl.msi / Data1.cab / _3FA7A09CB35C0381576AB1A76F85EA42 < prev    next >
Extensible Markup Language  |  2006-01-15  |  10KB  |  146 lines
  1. <?xml version="1.0" encoding="ISO-8859-1"?>
  2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
  3. <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
  4.         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  5.               This file is generated from xml source: DO NOT EDIT
  6.         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  7.       -->
  8. <title>event - Apache HTTP Server</title>
  9. <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  10. <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  11. <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
  12. <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  13. <body>
  14. <div id="page-header">
  15. <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
  16. <p class="apache">Apache HTTP Server Version 2.2</p>
  17. <img alt="" src="../images/feather.gif" /></div>
  18. <div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
  19. <div id="path">
  20. <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.2</a> > <a href="./">Modules</a></div>
  21. <div id="page-content">
  22. <div id="preamble"><h1>Apache MPM event</h1>
  23. <div class="toplang">
  24. <p><span>Available Languages: </span><a href="../en/mod/event.html" title="English"> en </a></p>
  25. </div>
  26. <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>An experimental variant of the standard <code class="module"><a href="../mod/worker.html">worker</a></code>
  27. MPM</td></tr>
  28. <tr><th><a href="module-dict.html#Status">Status:</a></th><td>MPM</td></tr>
  29. <tr><th><a href="module-dict.html#ModuleIdentifier">ModuleáIdentifier:</a></th><td>mpm_event_module</td></tr>
  30. <tr><th><a href="module-dict.html#SourceFile">SourceáFile:</a></th><td>event.c</td></tr></table>
  31. <h3>Summary</h3>
  32.  
  33.     <div class="warning"><h3>Warning</h3>
  34.       <p>This MPM is experimental, so it may or may not work as
  35.       expected.</p> 
  36.     </div>
  37.  
  38.     <p>The <code class="module"><a href="../mod/event.html">event</a></code> Multi-Processing Module (MPM) is
  39.     designed to allow more requests to be served simultaneously by
  40.     passing off some processing work to supporting threads, freeing up
  41.     the main threads to work on new requests.  It is based on the
  42.     <code class="module"><a href="../mod/worker.html">worker</a></code> MPM, which implements a hybrid
  43.     multi-process multi-threaded server.  Run-time configuration
  44.     directives are identical to those provided by
  45.     <code class="module"><a href="../mod/worker.html">worker</a></code>.</p>
  46.  
  47.     <p>To use the <code class="module"><a href="../mod/event.html">event</a></code> MPM, add
  48.       <code>--with-mpm=event</code> to the <code class="program"><a href="../programs/configure.html">configure</a></code>
  49.       script's arguments when building the <code class="program"><a href="../programs/httpd.html">httpd</a></code>.</p>
  50.  
  51. </div>
  52. <div id="quickview"><h3 class="directives">Directives</h3>
  53. <ul id="toc">
  54. <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#acceptmutex">AcceptMutex</a></li>
  55. <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#coredumpdirectory">CoreDumpDirectory</a></li>
  56. <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#enableexceptionhook">EnableExceptionHook</a></li>
  57. <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#group">Group</a></li>
  58. <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#listen">Listen</a></li>
  59. <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#listenbacklog">ListenBacklog</a></li>
  60. <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#lockfile">LockFile</a></li>
  61. <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#maxclients">MaxClients</a></li>
  62. <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#maxmemfree">MaxMemFree</a></li>
  63. <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#maxrequestsperchild">MaxRequestsPerChild</a></li>
  64. <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#maxsparethreads">MaxSpareThreads</a></li>
  65. <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#minsparethreads">MinSpareThreads</a></li>
  66. <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#pidfile">PidFile</a></li>
  67. <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#scoreboardfile">ScoreBoardFile</a></li>
  68. <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#sendbuffersize">SendBufferSize</a></li>
  69. <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#serverlimit">ServerLimit</a></li>
  70. <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#startservers">StartServers</a></li>
  71. <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#threadlimit">ThreadLimit</a></li>
  72. <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#threadsperchild">ThreadsPerChild</a></li>
  73. <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#threadstacksize">ThreadStackSize</a></li>
  74. <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#user">User</a></li>
  75. </ul>
  76. <h3>Topics</h3>
  77. <ul id="topics">
  78. <li><img alt="" src="../images/down.gif" /> <a href="#how-it-works">How it Works</a></li>
  79. <li><img alt="" src="../images/down.gif" /> <a href="#requirements">Requirements</a></li>
  80. <li><img alt="" src="../images/down.gif" /> <a href="#issues">Issues</a></li>
  81. </ul><h3>See also</h3>
  82. <ul class="seealso">
  83. <li><a href="worker.html">The worker MPM</a></li>
  84. </ul></div>
  85. <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  86. <div class="section">
  87. <h2><a name="how-it-works" id="how-it-works">How it Works</a></h2>
  88.     <p>This MPM tries to fix the 'keep alive problem' in HTTP. After a client
  89.     completes the first request, the client can keep the connection
  90.     open, and send further requests using the same socket. This can
  91.     save signifigant overhead in creating TCP connections. However,
  92.     Apache traditionally keeps an entire child process/thread waiting
  93.     for data from the client, which brings its own disadvantages. To
  94.     solve this problem, this MPM uses a dedicated thread to handle both
  95.     the Listening sockets, and all sockets that are in a Keep Alive
  96.     state.</p>
  97.  
  98.     <p>The MPM assumes that the underlying <code>apr_pollset</code>
  99.     implementation is reasonably threadsafe. This enables the MPM to
  100.     avoid excessive high level locking, or having to wake up the listener
  101.     thread in order to send it a keep-alive socket. This is currently
  102.     only compatible with KQueue and EPoll.</p>
  103.  
  104. </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  105. <div class="section">
  106. <h2><a name="requirements" id="requirements">Requirements</a></h2>
  107.     <p>This MPM depends on <a class="glossarylink" href="../glossary.html#apr" title="see glossary">APR</a>'s atomic
  108.     compare-and-swap operations for thread synchronization. If you are
  109.     compiling for an x86 target and you don't need to support 386s, or
  110.     you are compiling for a SPARC and you don't need to run on
  111.     pre-UltraSPARC chips, add
  112.     <code>--enable-nonportable-atomics=yes</code> to the
  113.     <code class="program"><a href="../programs/configure.html">configure</a></code> script's arguments. This will cause
  114.     APR to implement atomic operations using efficient opcodes not
  115.     available in older CPUs.</p>
  116.  
  117.     <p>This MPM does not perform well on older platforms which lack good
  118.     threading, but the requirement for EPoll or KQueue makes this
  119.     moot.</p>
  120.  
  121.     <ul>
  122.     
  123.       <li>To use this MPM on FreeBSD, FreeBSD 5.3 or higher is recommended.
  124.       However, it is possible to run this MPM on FreeBSD 5.2.1, if you
  125.       use <code>libkse</code> (see <code>man libmap.conf</code>).</li>
  126.  
  127.       <li>For NetBSD, at least version 2.0 is recommended.</li>
  128.  
  129.       <li>For Linux, a 2.6 kernel is recommended. It is also necessary to
  130.       ensure that your version of <code>glibc</code> has been compiled
  131.       with support for EPoll.</li>
  132.  
  133.     </ul>
  134. </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  135. <div class="section">
  136. <h2><a name="issues" id="issues">Issues</a></h2>
  137.     <p>At present, this MPM is incompatible with <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>, and
  138.     other input filters.</p>
  139. </div>
  140. </div>
  141. <div class="bottomlang">
  142. <p><span>Available Languages: </span><a href="../en/mod/event.html" title="English"> en </a></p>
  143. </div><div id="footer">
  144. <p class="apache">Copyright 1995-2006 The Apache Software Foundation or its licensors, as applicable.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
  145. <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div>
  146. </body></html>